home *** CD-ROM | disk | FTP | other *** search
/ The Original Shareware 1.1 / The Original Shareware (WeMake CDs)(Volume 1.1)(CDs, Inc)(1993).iso / 7 / zcomd289.zip / ZCOMMDOC.AA < prev    next >
Text File  |  1989-02-23  |  69KB  |  1,801 lines
  1.  
  2.  
  3.                                     Chuck Forsberg
  4.  
  5.                             The High Reliability Software
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.                                    User Manual for
  15.                                         ZCOMM
  16.  
  17.                             Universal Line Printer Edition
  18.  
  19.  
  20.                             ZCOMM Communications Software
  21.  
  22.                                       Featuring
  23.                             TurboLearn(TM) Script Writer,
  24.                  Cybernetic Data Recovery(TM), Error Containment(TM),
  25.                                          and
  26.                                    OverThruster(TM)
  27.  
  28.                      User Supported Communications Software Tools
  29.  
  30.  
  31.  
  32.                                    User Manual for
  33.                                         ZCOMM
  34.                             Universal Line Printer Edition
  35.  
  36.  
  37.                           Copyright 1989 Omen Technology Inc
  38.                                  All Rights Reserved
  39.  
  40.  
  41.  
  42.  
  43.  
  44.                              Omen Technology Incorporated
  45.  
  46.  
  47.  
  48.                             The High Reliability Software
  49.  
  50.                             Box 4681 Portland Oregon 97208
  51.                               VOICE: 503-621-3406 :VOICE
  52.                   TeleGodzilla Modem: 621-3746 Speed 1200,2400,19200
  53.                    Compuserve:70007,2304  GEnie:CAF  BIX:cforsberg
  54.                           UUCP: ...!tektronix!reed!omen!caf
  55.         c 1984, 1985, 1986, 1987, 1988, 1989  Omen Technology Inc.  All Rights Reserved.
  56.  
  57.  
  58.  
  59.         (C) 1988 Omen Tech Inc                                      Chapter 0
  60.  
  61.  
  62.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  63.         ZCOMM User Manual                                                    2
  64.  
  65.  
  66.         1.  INTRODUCTION
  67.  
  68.                     Get a Handle on the Information Explosion with
  69.                    ZCOMM(TM) User Supported Communications Software
  70.  
  71.         ZCOMM helps collect, control, and transmit information with a minimum
  72.         of time, hassle, and expense.  Concise commands and unobtrusive
  73.         displays facilitate telecommunications instead of distracting.
  74.  
  75.  
  76.         1.1  Data Capture
  77.  
  78.         ZCOMM captures text with many choices of parity bit and control
  79.         character editing.
  80.  
  81.         ZCOMM's Full-Time Capture Buffer(TM) saves scrolled data other
  82.         programs lose.  You can scroll, page, and string search to cut and
  83.         paste captured information.
  84.  
  85.         Omen's Error Containment(TM) technology minimizes errors caused by
  86.         line hits, and their effects on automatic scripts.
  87.  
  88.         When necessary, ZCOMM can capture binary data without protocols.
  89.         ZCOMM does not limit the length of captured files.
  90.  
  91.         1.2  File Transfer Protocols
  92.  
  93.         Years of communications experience distilled in ZCOMM provide rapid
  94.         file transfers with unmatched reliability.  Unsolicited customer
  95.         testimonials chronicle accurate file transfers under conditions that
  96.         crash the other programs, thanks to Omen Technology's Cybernetic Data
  97.         Recovery(TM) compatible logic enhancements and thorough protocol
  98.         stress testing.
  99.  
  100.         ZCOMM's protocols are more cost effective than the minimal, unreliable
  101.         XMODEM support available with other programs.  They are easier to find
  102.         and more useful than undocumented proprietary protocols.
  103.  
  104.         1.3  ZMODEM: The Sate of the Art in File Transfers
  105.  
  106.         ZMODEM How often has your modem disconnected when you were within the
  107.         last few bytes of a long, expensive file transfer?  With ZCOMM's
  108.         ZMODEM file transfers, you can resume the transfer from where you were
  109.         cut off, without wasted time or phone charges!  And, if the transfer
  110.         aborted because you ran out of disk space, ZMODEM can recover from
  111.         that too!
  112.  
  113.         ZMODEM transfers files and commands with a uniquely user friendly
  114.         interface.  Unlike traditional protocols, only one command or menu
  115.         choice is needed to transfer files or download commands.
  116.  
  117.  
  118.  
  119.         (C) 1988 Omen Tech Inc                          Chapter 1 Introduction
  120.  
  121.  
  122.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  123.         ZCOMM User Manual                                                    3
  124.  
  125.  
  126.         "The Autodownload feature for ZMODEM (and KERMIT) has got me
  127.         completely addicted."
  128.  
  129.         ZMODEM provides high throughput with full integrity even with
  130.         timesharing systems, high speed buffered modems, and packet switched
  131.         networks.  Unlike other "high speed protocols", ZMODEM's high speed
  132.         does not compromise reliability.  ZMODEM sets the throughput record
  133.         with 14 kilobit/second TrailBlazer modems tested at Telebit Corp.
  134.  
  135.         LZW compression provides spectacular throughput increases on suitable
  136.         files.
  137.  
  138.         A 32 bit Cyclic Redundancy Check, five orders of magnitude more
  139.         sensitive than CRC-16 and billions of times more sensitive than XMODEM
  140.         checksum protects your data.
  141.  
  142.         Other features include text file translation, selective transfer of
  143.         updated files, remote file maintenance.  Security authentication*
  144.         disables Trojan Horse attacks.  ZMODEM supports today's operating
  145.         systems by preserving exact file contents and modification date, even
  146.         between time zones.
  147.  
  148.         ZMODEM's speed and reliability have made it the protocol of choice
  149.         with progressive bulletin boards.  ZMODEM is available now on many
  150.         bulletin boards and timesharing systems.  Source code for
  151.         complementary Unix and VMS programs is provided in RZSZ.ARC.
  152.  
  153.         1.4  XMODEM: The Lowest Common Denominator
  154.  
  155.         ZCOMM supports the ubiquitous Ward Christensen "XMODEM" protocol with
  156.         Cybernetic Data Recovery(TM) and automatic file name generation.  Omen
  157.         Technology's exclusive Cybernetic Data Recovery(TM) transfers files
  158.         under conditions that crash other programs.
  159.  
  160.          + XMODEM CRC-16 Even today, few commercial programs support 16 bit
  161.            CRC, the standard of XMODEM file transfer technology since 1981.
  162.            CRC-16 error detection is orders of magnitude more accurate than
  163.            checksum.  Cybernetic Data Recovery(TM) catches and corrects
  164.            transmission errors that confound other programs.
  165.  
  166.          + True YMODEM(TM) batch file transfers preserve the exact file name,
  167.            file length and creation date.
  168.  
  169.          + XMODEM-1k and YMODEM-1k 1024 byte packets increase throughput with
  170.            bulletin boards, timesharing systems and networks.
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.         (C) 1988 Omen Tech Inc                          Chapter 1 Introduction
  180.  
  181.  
  182.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  183.         ZCOMM User Manual                                                    4
  184.  
  185.  
  186.         1.5  Kermit: A Cure for Brain Damage
  187.  
  188.         Kermit transfers ASCII and binary files with IBM, CDC, Cray, DEC, ICL,
  189.         Harris, Honeywell, Pr1me, Tandem, Univac and other mainframes that do
  190.         not support XMODEM.
  191.  
  192.         ZCOMM's 16 bit Kermit CRC is thousands of times more sensitive to
  193.         errors than other programs' 6 bit checksum.
  194.  
  195.          + Convenient Kermit AutoDownload saves keystrokes, resolves Kermit
  196.            dialect incompatibilities that stymie other programs.
  197.  
  198.          + Sliding Windows Kermit speeds file transfers with timesharing
  199.            systems, satellite and packet networks.  Also called SuperKermit,
  200.            it is the only high throughput download protocol available on The
  201.            Source(TM).
  202.  
  203.          + Kermit Long Packets speed file transfers with big IBM, CDC, and
  204.            Cray mainframe systems.
  205.  
  206.          + Advanced Kermit Server Access functions support low cost
  207.            networking.
  208.  
  209.         1.6  Swiss Army Knife for Protocols
  210.  
  211.          + Extended Quick-B streaming protocol slashes CompuServe download
  212.            costs up to 60 per cent or more.
  213.  
  214.          + OverThruster(TM) Speeds XMODEM and YMODEM downloads
  215.  
  216.          + ZCOMM supports bulletin boards and traditional communications
  217.            programs with MODEM7 batch, Telink/FIDO, and Clink/SEAlink file
  218.            transfer protocols.
  219.  
  220.          + WXMODEM (Windowed XMODEM) speeds People-Link(TM) timesharing
  221.            service downloads.
  222.  
  223.         1.7  X.PC: Your Own Packet Gateway
  224.  
  225.         The X.PC network interface protocol flavor supports low level flow
  226.         control, error correction, multiple virtual calls and concurrent data
  227.         capture on one modem line.
  228.  
  229.  
  230.         1.8  Controlling Information
  231.  
  232.         ZCOMM's Full-Time Capture Buffer(TM) lets you flip back and forth or
  233.         search, scanning two hundred messages from bulletin boards in a couple
  234.         of minutes.  (It has to be seen to be believed.) To compose a reply,
  235.         call your favorite editor (the one you've already learned!) as a
  236.         subroutine without losing your place.
  237.  
  238.  
  239.         (C) 1988 Omen Tech Inc                          Chapter 1 Introduction
  240.  
  241.  
  242.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  243.         ZCOMM User Manual                                                    5
  244.  
  245.  
  246.         ZCOMM's high speed screen driver makes life pleasant:
  247.  
  248.         + Easy on the eyes: ZCOMM supports No Flicker displays, up to 450 per
  249.           cent faster than DOS
  250.  
  251.         + VT102, VT100, TTY 5425, ANSI, Z19, VT52, TI 940, IBM 3101, Televideo
  252.           9xx, and ADM3a emulation.
  253.  
  254.         + Supports 132 columns and advanced displays (114x60, etc.)
  255.  
  256.         + VT100 character graphics and keyboard mapping support "visual"
  257.           programs.  Unlike Microsoft Access, Crosstalk, and most "VT100"
  258.           emulators, ZCOMM correctly displays EDT, AllIn1, and DEC Store on an
  259.           XT even at 19200 baud.
  260.  
  261.         + Hardcopy Terminal Emulation previews printer output by converting
  262.           overprint sequences to bold or underlined characters.
  263.  
  264.         + Visual (silent) bell preserves domestic tranquillity
  265.  
  266.         + Settable number of lines and columns, border color, default colors,
  267.           autowrap, keyboard mapping enable.
  268.  
  269.         Full pathnames, directories, and wildcards support file transfers and
  270.         utility commands.  Output may be redirected to printers or appended to
  271.         files.  Files may be listed, paged, copied, renamed, searched, edited,
  272.         and deleted.  Accuracy and identity of files transmitted by any means
  273.         are verified by word count and two types of checksum/CRC's.  Matching
  274.         C Source code is available for many of these functions.
  275.  
  276.         ZCOMM can search files for lines matching a string, insensitive to
  277.         case.
  278.  
  279.  
  280.         1.9  Transmitting Information
  281.  
  282.         + Dual stack Command Recall saves your keyboarded host commands in a
  283.           history file for search, recall, editing, and reentry.
  284.         + Convenient Split Screen option allows responsive local editing of
  285.           input lines before transmission.
  286.         + A rich palette of editing and timing modes permit file and message
  287.           upload, even to fussy microcomputer Bulletin Boards.
  288.         + Remote access for file transfers and DOS program execution with baud
  289.           rate detection and three passworded security levels.
  290.         + Outcall Queue intersperses scheduled outgoing calls with incoming
  291.           messages on one modem line.
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.         (C) 1988 Omen Tech Inc                          Chapter 1 Introduction
  300.  
  301.  
  302.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  303.         ZCOMM User Manual                                                    6
  304.  
  305.  
  306.         1.10  Other Features
  307.  
  308.  
  309.         Interrupt driven modem input allows High speed operation with file
  310.         transfer and conversational terminal operation at 19200 bps and above.
  311.         One of 7 modem "ports" may be selected at any time.
  312.  
  313.         A real-time status line displays column, row, time, elapsed time,
  314.         transmission speed, and other important information.
  315.  
  316.         Soft keys provide convenient execution of common commands.
  317.  
  318.         ZCOMM is written in C for performance, portability and
  319.         maintainability.  ZCOMM loads quickly from a moderately sized
  320.         executable file with no cumbersome overlays.
  321.  
  322.         Almost two decades of telecommunications knowledge are distilled in
  323.         ZCOMM.
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.         (C) 1988 Omen Tech Inc                          Chapter 1 Registration
  360.  
  361.  
  362.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  363.         ZCOMM User Manual                                                    7
  364.  
  365.  
  366.         2.  ZCOMM REGISTRATION
  367.  
  368.         ZCOMM is a user supported program developed and supported by Chuck
  369.         Forsberg.  ZCOMM is not and never has been public domain.
  370.  
  371.         ZCOMM may not be modified, patched, hacked, disassembled, decompiled,
  372.         or otherwise reverse engineered, or sold, without prior written
  373.         permission by Omen Technology Inc.
  374.  
  375.         The only legitimate way to disable the opening advertisement in ZCOMM
  376.         is to insert an authorized SNP obtained from Omen Technology into
  377.         ZCOMM with the putsnp program.  Any other suppression or modification
  378.         of the opening screen is illegal, unethical, and prohibited.
  379.  
  380.         Distribution of programs and/or instructions on how to modify, patch,
  381.         disassemble, decompile, or otherwise reverse engineer ZCOMM without
  382.         prior written permission by Omen Technology Inc is a theft of services
  383.         and a violation of federal copyright law, and will be referred to the
  384.         FBI for investigation and prosecution under federal conspiricy
  385.         statutes.  Applicable RICO law provides for treble damages and
  386.         recovery of attorney's fees.
  387.  
  388.         Distribution of ZCOMM in any medium without this documentation file
  389.         constitutes an unauthorized modification.
  390.  
  391.         Individuals may use ZCOMM with only a moral obligation to register
  392.         their copy with Omen Technology.  You may distribute the unmodified
  393.         ZCOMM*.ARC files to as many as you wish, or post them on bulletin
  394.         boards, etc.  Businesses must register their copies of ZCOMM.
  395.  
  396.         Registration buys you:
  397.  
  398.            + A clear conscience.
  399.  
  400.            + Your own unique ZCOMM Serial Number Password (ZSNP).  Your ZSNP
  401.              may be applied to copies of ZCOMM to be run on a single machine.
  402.  
  403.                 + Serialized of ZCOMM deactivates the registration request
  404.                   display and the pause afterwards.
  405.  
  406.                 + Serialization activates the egrep, egrepm, expand, split,
  407.                   and ss commands and the outcall queue.  Features denoted
  408.                   with ** are available in serialized copies of ZCOMM.
  409.  
  410.                 + Serialization more than doubles the circular buffer size.
  411.  
  412.            + A software disk with the current version of ZCOMM, the putsnp
  413.              program to serialize your copy of ZCOMM with your ZSNP, and the
  414.              tree structured "flash-up" help processor and help file included
  415.              in ZCOMMHLP.ARC.
  416.  
  417.  
  418.  
  419.         (C) 1988 Omen Tech Inc                          Chapter 2 Registration
  420.  
  421.  
  422.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  423.         ZCOMM User Manual                                                    8
  424.  
  425.  
  426.            + The complete Professional-YAM User Manual, 218 Typeset pages,
  427.              with many chapters not included here, ready for insertion into a
  428.              PC size binder.
  429.  
  430.            + The Pro-YAM Crib Sheet.
  431.  
  432.            + A ZCOMM registration is worth $40.00 when upgrading to
  433.              Professional-YAM.  This upgrade includes the Pro-YAM software
  434.              disks and license.  You will already have the manual from your
  435.              ZCOMM registration package.
  436.  
  437.         REGISTRATION FEES:
  438.  
  439.            + Basic registration (ZSNP, disk, manual pages): $40.00
  440.  
  441.            + Custom Binder (OPTIONAL): $10.00
  442.  
  443.            + ONE of the following:
  444.  
  445.                 + Domestic Shipping (UPS surface): $5.00
  446.  
  447.                 + Domestic Surface Shipping: Free with prepaid orders
  448.  
  449.                 + International Air Mail (most countries): $15.00[1]
  450.  
  451.            + Domestic UPS Second Day AIR: $5.00 additional
  452.  
  453.         Don't bother scrounging for an envelope, use the INSTANT MAILER
  454.         included in this archive!
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.         __________
  474.  
  475.          1. $25.00 to Australia etc. if binder included due to higher cost.
  476.  
  477.  
  478.  
  479.         (C) 1988 Omen Tech Inc                                 Chapter 2 ZCOMM
  480.  
  481.  
  482.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  483.         ZCOMM User Manual                                                    9
  484.  
  485.  
  486.         3.  ZCOMM's Big Brother
  487.  
  488.         ZCOMM is the Little Brother of Professional-YAM.  As powerful as ZCOMM
  489.         is, more powerful than other user supported software, it pales beside
  490.         Omen Technology's commercial Professional-YAM software.
  491.  
  492.         Pro-YAM's TurboDial(TM) script language provides state of the art real
  493.         time pattern recognition, "regular expiression" string parsing, script
  494.         development aids, script encryption, queue management, extensive
  495.         logging facilities, and finely tuned security control unmatched in the
  496.         industry.
  497.  
  498.         Fortune 500 corporations use these exclusive features to support large
  499.         PC based telecommunications projects involving attended and unattended
  500.         operation.
  501.  
  502.         Specialized utility commands allow Pro-YAM and a PC or DG/One portable
  503.         to replace data line monitors in many applications.  Pro-YAM supports
  504.         Echoplex uploads and high speed data dumps in addition to the uniquely
  505.         accurate and robust XMODEM, YMODEM, ZMODEM, and Kermit protocol
  506.         transfers shared with ZCOMM.  Pro-YAM has many powerful utility
  507.         commands that earn it the sobriquet Integrated Communications Tools.
  508.  
  509.         Pro-YAM is available with the Tymnet X.PC link level protocol for
  510.         multiple, concurrent data transfers.
  511.  
  512.         Omen Technology also markets highly compatible Unix and Xenix flavors
  513.         of Pro-YAM.
  514.  
  515.         Omen Technology's Demand Upgrade(TM) technology and small company
  516.         responsiveness meet the support needs of a growing base of demanding
  517.         customers.
  518.  
  519.         Professional-YAM is a superset of ZCOMM; applications and scripts
  520.         developed on ZCOMM will operate with Pro-YAM.
  521.  
  522.         This ZCOMM manual omits descriptions of many Pro-YAM features not
  523.         included in ZCOMM.  The special symbol * denotes Pro-YAM features not
  524.         included in ZCOMM.
  525.  
  526.         Pro-YAM features not included in ZCOMM include X.PC, encryption,
  527.         CryptoScript(TM) capability, Password Guardian(TM), logs, the ap, apd,
  528.         bdump, fget, fput, kbdmon, link, obey, on, portx, purgek, quit,
  529.         restime, restrict, timestamp, trs, and usq commands, and certain
  530.         vertical application and security related features.  (Newer versions
  531.         of ZCOMM include the logging facility.)
  532.  
  533.         In some places you will see references to a fake Chapter 99.  Pro-YAM
  534.         manual chapters not included in this document are designated by
  535.         Chapter 99.
  536.  
  537.  
  538.  
  539.         (C) 1988 Omen Tech Inc                                 Chapter 3 ZCOMM
  540.  
  541.  
  542.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  543.         ZCOMM User Manual                                                   10
  544.  
  545.  
  546.         ZCOMM registration can be upgraded to Pro-YAM as described in the
  547.         previous chapter.
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.         (C) 1988 Omen Tech Inc                     Chapter 3 Design Philosophy
  600.  
  601.  
  602.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  603.         ZCOMM User Manual                                                   11
  604.  
  605.  
  606.         4.  DESIGN PHILOSOPHY
  607.  
  608.         ZCOMM is a Communications Tool.  Once learned, ZCOMM's command
  609.         interface is more powerful, faster, and less cumbersome than a menu
  610.         interface.  Indeed, menus comprehensive enough to describe all the
  611.         nuances of ZCOMM's capabilities would take up more memory than most
  612.         microcomputers can afford.  In addition, remote operation of ZCOMM
  613.         would be excruciatingly slow due to transmission delays displaying the
  614.         appropriate menu pages.
  615.  
  616.         ZCOMM's look and feel has been influenced by the MODEM series of
  617.         programs, the Unix(TM) Operating System, the Berkeley Editor (vi),
  618.         CP/M(TM), PC-DOS, and ANSI standards.
  619.  
  620.         Function keys F1 and F2 have been assigned with a logical grouping.
  621.         Wherever meaningful, F1 exits from a function, and F2 enters the
  622.         logical "next" function.  From the command prompt, F2 enters the term
  623.         function, and from there another F2 enters the review function.  Once
  624.         in the review function (assuming it was called from the term
  625.         function), F1 exits back to the term function, from where another F1
  626.         exits to the command prompt.
  627.  
  628.         Another ethic guiding ZCOMM's design is respect for the user's
  629.         information.  The user's data is, after all, precisely what a modem
  630.         program is all about.  Status information is limited to one CRT line
  631.         to allow maximum screen size for data.  Fancy display modes such as
  632.         reverse video are used sparingly to avoid distracting from the user's
  633.         work.
  634.  
  635.         If you seek a video arcade modem game, ZCOMM will disappoint you.
  636.  
  637.         4.1  Circular Buffer
  638.  
  639.         The circular buffer remotely resembles the linear "capture buffer"
  640.         used by other modem programs.  Many ZCOMM commands involve the
  641.         circular buffer, including the t, f, wait, ki, kill, w, review, and
  642.         close commands.
  643.  
  644.         The term function uses the circular buffer as a first in, first out
  645.         (FIFO) buffer for data arriving from the remote.  The circular
  646.         organization of this buffer makes the most recent data always
  647.         available for review and arbitrary writing to disk files.
  648.  
  649.         When the circular buffer has been filled and the XOFF character sent
  650.         to the remote, ZCOMM writes the contents of the circular buffer to the
  651.         receive file if a receive file has been opened.  ZCOMM then checks
  652.         whether any characters remain to be written to the printer.  When both
  653.         of these checks are satisfied, ZCOMM then sends an XON character to
  654.         the remote to resume the transmission of data.
  655.  
  656.         The ALT-W command or j mode can be used to write the contents of the
  657.  
  658.  
  659.         (C) 1988 Omen Tech Inc                       Chapter 4 Circular Buffer
  660.  
  661.  
  662.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  663.         ZCOMM User Manual                                                   12
  664.  
  665.  
  666.         circular buffer to the receive file without waiting for the circular
  667.         buffer to fill up first.
  668.  
  669.         The large storage capacity of the circular buffer may be used to
  670.         review the most recent data received from the remote.  The review
  671.         command allows one to page back and forth through the data received
  672.         from the remote.  Forwards and backwards string searches make it easy
  673.         to locate important text.  The review command also allows segments of
  674.         the data in the circular buffer to be selectively saved on disk (cut
  675.         and pasted).  Scripts can search and mark text received from the
  676.         remote with the full power of regular expression pattern matching.
  677.  
  678.  
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.         (C) 1988 Omen Tech Inc                         Chapter 4 Rosetta Stone
  720.  
  721.  
  722.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  723.         ZCOMM User Manual                                                   13
  724.  
  725.  
  726.         5.  ROSETTA STONE
  727.  
  728.         Alphanumeric An alphanumeric character is either a letter or a decimal
  729.             digit 0 to 9.
  730.  
  731.         Baud A baud is a signaling unit conveying one or more bits of
  732.             information.  Baudrate is commonly (and usually incorrectly)
  733.             interchanged with bits per second.
  734.  
  735.         BPS is an abbreviation for "bits per second", a measure of
  736.             transmission speed.  ASCII Asynchronous transmission generally
  737.             uses 10 bits to transmit each character, so the speed in
  738.             characters per second is one tenth the speed measured in bits per
  739.             second.
  740.  
  741.         Capture The term function captures data from the remote into the
  742.             circular buffer.  This data may be paged back and forth with the
  743.             review function, or written to a disk file.
  744.  
  745.         Character Escape is a sequence of characters initiated by a backslash
  746.             character used to represent a control character or programmable
  747.             string using printable characters.  Character escapes are
  748.             described in Chapter 23.
  749.  
  750.         CPMEOF A control character (hex 1A) added to the end of text files by
  751.             traditional microcomputer programs.  This practice was popular
  752.             with the Digital Research CP/M 8 bit operating system.
  753.  
  754.         Crash Recovery(TM) refers to the ZMODEM File Transfer Protocol's
  755.             ability to resume file transfers that have been interrupted by a
  756.             line disconnect from the point where the transfer was interrupted.
  757.  
  758.         Cyclical Redundancy Check (CRC) is a datum (16 or 32 bits) generated
  759.             by a cyclic code.  The CRC-16 extension to the Ward Christensen
  760.             XMODEM protocol provides a high level of data integrity.  CRC-16
  761.             guarantees detection of all single and double bit errors,  all
  762.             errors with an odd number of error bits, all burst errors of
  763.             length 16 or less, 99.9969% of all 17-bit error bursts, and
  764.             99.9984 per cent of all possible longer error bursts.  The actual
  765.             performance is even better because the errors that sneak by CRC-16
  766.             are often detected by the other error checks simultaneously
  767.             applied by ZCOMM's Cybernetic Data Recovery(TM).  ZMODEM's 32 bit
  768.             CRC provides five orders of magnitude more accurate error
  769.             detection than XMODEM's CRC-16 a billion times more accurate than
  770.             8 bit checksum used by standard XMODEM..
  771.  
  772.         Download is the transfer of data from the remote system down to your
  773.             computer.
  774.  
  775.         DTR is an abbreviation for Data Terminal Ready.  Data Terminal Ready
  776.             is a signal sent by the computer to the modem to condition it to
  777.  
  778.  
  779.         (C) 1988 Omen Tech Inc                         Chapter 5 Rosetta Stone
  780.  
  781.  
  782.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  783.         ZCOMM User Manual                                                   14
  784.  
  785.  
  786.             accept commands or answer an incoming call.  When DTR is "dropped"
  787.             (switched off), the modem should disconnect from the line.
  788.  
  789.         Execute When a string parameter is executed, it is normally sent to
  790.             the remote (modem).  If it begins with "@", the remainder is
  791.             executed as a ZCOMM command.
  792.  
  793.         Filespec Some ZCOMM commands instruct a remote Kermit server program
  794.             to send, receive, print, type, or delete one or more files.  The
  795.             syntax of this specification is defined by the remote Kermit
  796.             server program, not ZCOMM.  If filespec contains spaces, filespec
  797.             must be enclosed by double quotes.
  798.  
  799.         Flow Control restrains the speed of transmission to prevent loss of
  800.             data when a fast sender must communicate with a slower receiver.
  801.             Hardware signals, control characters, and protocol handshakes can
  802.             be used to provide restraint, singly or in combinations.
  803.  
  804.             SEE ALSO: handshake command, zmodem w parameter, Flow Control
  805.             Chapter 13
  806.  
  807.         Functions are operations supported by ZCOMM, such as a dir, type, s,
  808.             r, or t (term) command.  A command may set or reset mode[s],
  809.             change a parameter, or perform a function.
  810.  
  811.         Host Operation allows remote access of files and programs.
  812.  
  813.         Iff If and only if.
  814.  
  815.         Integrity in a data transfer protocol refers to the ability of the
  816.             protocol to guarantee a correct data transfer provided both sender
  817.             and receiver report a successful transfer.  Integrity is a
  818.             different measure of a file transfer protocol than robustness,
  819.             which is a measure of a protocol's ability to complete the
  820.             requested transfers in the presence of errors, independent of the
  821.             probability of undetected errors in the file transfer.
  822.  
  823.         Kermit ia an error correcting batch file transfer protocol developed
  824.             at Columbia University and elsewhere.  The Kermit protocol
  825.             supports text and binary file transfers with many mainframe
  826.             computers whose hardware and operating software preclude
  827.             implementation of high performance protocols.  Kermit
  828.             implementations exist for many mainframes that cannot support the
  829.             XMODEM protocol.
  830.  
  831.         Line Hit A burst of noise on a telephone line may generate modem data
  832.             errors.  A single noise burst may garble dozens of characters.
  833.             ZCOMM's Error Containment(TM) technology may be used to reduce the
  834.             number of characters garbled by each line hit.
  835.  
  836.  
  837.  
  838.  
  839.         (C) 1988 Omen Tech Inc                         Chapter 5 Rosetta Stone
  840.  
  841.  
  842.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  843.         ZCOMM User Manual                                                   15
  844.  
  845.  
  846.         Modes Many modes are available to modify the way the term function
  847.             receives, displays, transmits, and stores data.
  848.  
  849.         Options Options apply to the Kermit, s, sx, sb, s7, st, r, rx, r7, rb,
  850.             and rc protocol file transfer commands.
  851.  
  852.         q.v. Quod Vide is Latin for "which see", an invitation to consult
  853.             information on the subject mentioned.
  854.  
  855.         Pathname is a complete file name, including disk and directories.
  856.  
  857.             EXAMPLE: c:/ZCOMM/PHODIR.t
  858.  
  859.  
  860.         Pathspec ... A pathspec consists of zero or more pathnames.
  861.  
  862.             Unambiguous and ambiguous (with wildcard characters) pathnames may
  863.             be specified in any combination.  The wildcard filename characters
  864.             * and ?  are allowed as described in the IBM DOS manual chapter
  865.             "Global Filename Characters".  In DOS, only the filename portion
  866.             of the pathname may contain wildcards.
  867.  
  868.             EXAMPLE: src/cmd/*.c is legal; src/*/foo.c is not.
  869.  
  870.  
  871.             On 32 bit Unix systems, ZCOMM expands "*" and "?" the way the
  872.             shell does.  All the shell wildcards may be used including
  873.             multiple wildcards, wildcards in directories, and ranges.  ~user
  874.             expands to the login directory of user, and ~ expands to your home
  875.             directory.  In addition, `command` takes the output of command as
  876.             a series of pathnames.
  877.  
  878.             EXAMPLE: dir */[a-i]* displays all files starting with "a" to "i"
  879.             in all subdirectories immediately below the current directory.
  880.  
  881.  
  882.             An empty pathspec represents all files in the current directory on
  883.             the current disk.  A disk identifier without any file names
  884.             represents all files on that disk's current directory.  A
  885.             directory pathname expands to all files in the specified
  886.             directory.
  887.  
  888.             Sequences of the form %svar are replaced by the value (possibly
  889.             empty) of the string parameter svar.  If svar is not a string
  890.             parameter, no substitution is made.
  891.  
  892.             A pathspec may contain any combination of the above, separated by
  893.             spaces or tabs.
  894.  
  895.             If pathspec includes a disk specifier (such as a: or b:), ZCOMM
  896.             checks the disk specifier against the list of permissible disk
  897.  
  898.  
  899.         (C) 1988 Omen Tech Inc                         Chapter 5 Rosetta Stone
  900.  
  901.  
  902.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  903.         ZCOMM User Manual                                                   16
  904.  
  905.  
  906.             specifiers in the string parameter disks.
  907.  
  908.             The various filename expansions are especially useful in the
  909.             context of commands such as wc, sum, chek, crc, find, sb, and sz.
  910.             For example, wc applies to all files in the current directory, and
  911.             wc dir applies to all files in dir.
  912.  
  913.             ZCOMM pathnames may use / or \ to delimit directories.
  914.  
  915.         Regular Expressions control pattern matching and grouping of text by
  916.             the ss and egrep commands.  "Magic" characters specify the pattern
  917.             matching and grouping processes.
  918.  
  919.         Remote refers to the machine or terminal with which ZCOMM is
  920.             communicating.  This could be a direct RS-232 connection to a
  921.             local terminal, micro, mini, or mainframe, or a timesharing system
  922.             accessed through a modem and a global packet switched network.
  923.  
  924.         Restraint See "Flow Control" above.
  925.  
  926.         Restricted For security reasons, ZCOMM is restricted to prevent
  927.             unauthorized dial-in users from accessing private data or crashing
  928.             the system.  Certain commands are illegal when ZCOMM is
  929.             restricted, and only specified disk drives and directories may be
  930.             accessed.
  931.  
  932.         Review Function The last 32k characters of output from the remote may
  933.             be paged and searched online with the review function.  This data
  934.             may also be cut and pasted to disk files.
  935.  
  936.         Robustness in a file transfer protocol refers to the protocol's
  937.             ability to complete transfers in the presence of errors induced by
  938.             line noise or other sources.  Robustness is a different measure of
  939.             a file transfer protocol than integrity, a measure of the
  940.             probability of correct data transfer given a successful completion
  941.             of the transfer process.
  942.  
  943.         Script A script is a set of commands that control dialogues with the
  944.             user or a remote system.
  945.  
  946.         Script Level refers to the degree of nesting of scripts.  Level 0 is
  947.             called by the user directly, and each higher level is executed by
  948.             a gosub or other command from the previous level.
  949.  
  950.         Shell Escape is a DOS command or program called as a subroutine from
  951.             ZCOMM via a DOS Gateway.  The phrase "shell escape" comes from the
  952.             Unix(TM) Operating System, whose command interpreter is called
  953.             "the shell".
  954.  
  955.         Soft Keys Strings or commands may be assigned to the Soft Keys with
  956.             set commands, including those in the telephone directory "setup"
  957.  
  958.  
  959.         (C) 1988 Omen Tech Inc                         Chapter 5 Rosetta Stone
  960.  
  961.  
  962.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  963.         ZCOMM User Manual                                                   17
  964.  
  965.  
  966.             entry executed each time ZCOMM starts.  ZCOMM recognizes the forty
  967.             function key codes produced by the function keys F1 to F12.  FS1
  968.             to FS12 are obtained with a Shift key, FC1 to FC12 are obtained
  969.             with the Ctrl key, and FA1 to FA12 are obtained with the Alt key.
  970.             The cursor keys and extra function keys on 101 key Extended
  971.             Keyboards are also recognized.
  972.  
  973.             Strings or commands may be assigned to BS, ESC, Ins, Del, Home,
  974.             End, Up, Down, Left, Right, PgUp, and PgDn, overriding their
  975.             normal functions in the term function.
  976.  
  977.         String Some commands take a string argument.  If a string argument
  978.             contains spaces, tabs, and a semicolon, it must be enclosed by
  979.             double quotes (shift single quote on the IBM PC keyboard).
  980.             Control characters may be included in strings with character
  981.             escapes similar to those used by the C Programming Language.
  982.  
  983.         Term Function ZCOMM's Term Function provides the conversational
  984.             "connection" between the user and the remote.  The term function
  985.             captures data from the remote into ZCOMM's circular buffer from
  986.             whence it may be displayed, printed, stored in a disk file, or
  987.             searched, cut and pasted by the review function.
  988.  
  989.         TWX Teletypewriter Exchange (Teletype Corp. TM).  A simple protocol
  990.             used to transmit files or paper tapes between dial-up
  991.             teleprinters.
  992.  
  993.         Upload is a transfer of data from your computer up to the remote
  994.             system.
  995.  
  996.         Wild Card Many commands allow wild card file names in their pathspec
  997.             (q.v.).
  998.  
  999.         Writing When a receive file is open as a result of a create or t
  1000.             filename command, data in the circular buffer is written out to
  1001.             the receive file when the circular buffer fills up or when a w or
  1002.             ALT-W command is given.
  1003.  
  1004.         XMODEM The Ward Christensen file transfer protocol uses 128 byte
  1005.             packets, one byte control messages, and a one byte arithmetic
  1006.             checksum.
  1007.  
  1008.         XMODEM/CRC A synonym for the enhanced Ward Christensen XMODEM protocol
  1009.             using a Cyclic Redundancy Check (CRC-16).  Newer programs support
  1010.             CRC-16 for better data integrity, but reliability is still
  1011.             compromised by one byte control messages.
  1012.  
  1013.         XMODEM-1k XMODEM protocol with 1024 byte data packets, CRC-16, and one
  1014.             byte control messages, sometimes incorrectly called ymodem.
  1015.  
  1016.  
  1017.  
  1018.  
  1019.         (C) 1988 Omen Tech Inc                         Chapter 5 Rosetta Stone
  1020.  
  1021.  
  1022.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  1023.         ZCOMM User Manual                                                   18
  1024.  
  1025.  
  1026.         YMODEM YMODEM is a batch file transfer protocol with pathname, date,
  1027.             file length and other file data in block 0, CRC-16 default, and
  1028.             optional 1024 byte packets.  Many programs claiming to support
  1029.             YMODEM actually use XMODEM with 1024 byte blocks; use ZCOMM's sx
  1030.             -k and rx commands with these XMODEM mutants.
  1031.  
  1032.         XOFF, XON ASCII control characters control the flow of data.  XOFF
  1033.             (Ctrl-S) stops and XON (Ctrl-Q) resumes the flow of data.  Chapter
  1034.             29 provides an ASCII code chart with the names for the control
  1035.             characters.
  1036.  
  1037.         ZCOMM is a shareware (User Supported) subset of Professional-YAM.
  1038.  
  1039.         ZMODEM An advanced public domain file transfer protocol with
  1040.             simplified human interface, crash recovery, high speed streaming,
  1041.             sensitive 32 bit CRC, command download, security features, and
  1042.             important file management functions.
  1043.  
  1044.         {arg1 | arg2} One of the arguments separated by | is required.
  1045.  
  1046.         []  Optional argument.
  1047.  
  1048.         *   The special symbol * denotes features not included in ZCOMM.  **
  1049.             Denotes features not included in userialized (unregistered) copies
  1050.             of ZCOMM.
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.         (C) 1988 Omen Tech Inc                      Chapter 5 Installing ZCOMM
  1080.  
  1081.  
  1082.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  1083.         ZCOMM User Manual                                                   19
  1084.  
  1085.  
  1086.         6.  INSTALLING ZCOMM
  1087.  
  1088.         If you have registered your copy of ZCOMM, make yourself a working
  1089.         copy of the ZCOMM distribution disk using the DOS diskcopy command to
  1090.         make exact copies.  Keep the distribution disk in a safe place away
  1091.         from nasty data killers such as disk drives, displays, computers,
  1092.         magnets, motors, and coffee cups.  The only time the distribution
  1093.         diskette should be out and about is when you are cloning your working
  1094.         copies.
  1095.  
  1096.  
  1097.         6.1  Installation from Registration Disk
  1098.  
  1099.  
  1100.         The putsnp program inserts your ZCOMM Serial-Number-Password (ZSNP)
  1101.         into your working copiy of ZCOMM.  Installing a legal serial number
  1102.         suppresses the pause after the opening message, enlarges the circular
  1103.         buffer, and enables new commands.  The putsnp program prompts for your
  1104.         Serial/Number/Password (SNP) of the form X123456789.  Putsnp checks
  1105.         for keyboarding mistakes and then verifies that you understand and
  1106.         agree to the licensing conditions.  When you understand and agree to
  1107.         the licensing conditions, respond with yes (not just y).
  1108.  
  1109.         Then putsnp prompts for the name of a file to insert the serial number
  1110.         into.  This should be a ZCOMM.EXE file that you have transferred to a
  1111.         scratch disk, or to an appropriate directory on your hard disk.  Do
  1112.         not write on the distribution diskette unless a nuclear attack is in
  1113.         progress.
  1114.  
  1115.         After inserting the serial number in the given file, putsnp asks if
  1116.         you wish to change the default value for the phone directory pathname
  1117.         (string parameter phones).  This is normally /PHODIR.t.  If you wish
  1118.         to keep the phones file elsewhere, answer "yes".[1] Putsnp then
  1119.         searches for the location in your copy of ZCOMM that contains this
  1120.         information.  When found, you may enter a new pathname,[2] up to 64
  1121.         characters.
  1122.  
  1123.         Afterwards, you should copy the help processor files YHP.EXE and
  1124.         ZMANH.HLP from the disk.
  1125.  
  1126.  
  1127.  
  1128.  
  1129.  
  1130.         __________
  1131.  
  1132.          1. The default value may also be overidden with the PHONES DOS
  1133.             environment variable.
  1134.  
  1135.          2. Such as c:/zcomm/PHODIR.t.
  1136.  
  1137.  
  1138.  
  1139.         (C) 1988 Omen Tech Inc                      Chapter 6 Installing ZCOMM
  1140.  
  1141.  
  1142.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  1143.         ZCOMM User Manual                                                   20
  1144.  
  1145.  
  1146.         6.2  Installation from ZCOMM*.ARC
  1147.  
  1148.  
  1149.         If you are using the software provided in ZCOMM*.ARC, be sure to save
  1150.         the original files for backup, and pass them on to your friends to
  1151.         fill their communications needs.  There are currently three ZCOMM
  1152.         archive files:
  1153.  
  1154.           + ZCOMMEXE.ARC contains the executable program and demonstration
  1155.             files.
  1156.  
  1157.           + ZCOMMDOC.ARC contains this documentation.
  1158.  
  1159.           + ZCOMMHLP.ARC contains ZCOMM's tree structured help file and random
  1160.             access flash-up help processor.
  1161.  
  1162.  
  1163.         6.3  Installation Continued
  1164.  
  1165.  
  1166.         The second order of business is to read this manual.  There is just no
  1167.         way you can get your money's worth out of ZCOMM without reading, or at
  1168.         least carefully scanning, this manual.  After all, didn't you get
  1169.         ZCOMM because you needed something more powerful than that cumbersome,
  1170.         unreliable, brain-damaged menu driven crock you've been using?
  1171.         (Perhaps you shouldn't answer that question just yet ...)
  1172.  
  1173.         You can then edit PHODIR.t to suit your own needs by inserting
  1174.         directory entries for the systems you wish to call and changing the
  1175.         phone numbers, account numbers, and passwords on the "standard"
  1176.         entries for popular timesharing services that you have accounts with.
  1177.         Be sure to check the setup entry and make any changes you feel
  1178.         appropriate.  Once you have the "feel" of ZCOMM, you will want to
  1179.         remove the automatic menu invocation at the end of the setup directory
  1180.         entry.
  1181.  
  1182.         Chapter 9 gives a line by line tutorial for setting up your telephone
  1183.         directory assuming you are using a standard modem.
  1184.  
  1185.         If you are using a computer that runs at non standard clock rates
  1186.         (e.g., 8 mHz 8088 instead of 4.77 mHz) or with an enhanced CPU chip
  1187.         (NEC V20), you will need to set special values for the a and b numeric
  1188.         parameters as described in Chapter 21.
  1189.  
  1190.         **** WARNING **** Although ZCOMM is well behaved as communications
  1191.         programs go, some memory resident programs, special keyboard
  1192.         modifiers, print spoolers, or special display drivers, may cause
  1193.         problems.  The POLYTRON memory-resident desktop organizer PolyWindows
  1194.         DeskPlus as well as POLYBoost work with ZCOMM.
  1195.  
  1196.         **** WARNING **** Since ZCOMM uses interrupts to read data from the
  1197.  
  1198.  
  1199.         (C) 1988 Omen Tech Inc                      Chapter 6 Installing ZCOMM
  1200.  
  1201.  
  1202.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  1203.         ZCOMM User Manual                                                   21
  1204.  
  1205.  
  1206.         serial ports, each serial port must be strapped for its proper
  1207.         interrupt vector.  Some communications programs assign both IRQ3 and
  1208.         IRQ4 while operating, so they will operate even if the serial ports
  1209.         are not strapped properly.  Since ZCOMM only assigns the interrupt
  1210.         vector of the port in use, incorrect IRQ level strapping will crash
  1211.         ZCOMM.  Check the serial port addresses and vectors with the
  1212.         information given ith the port command in Chapter 15 if you encounter
  1213.         trouble starting ZCOMM.
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.         (C) 1988 Omen Tech Inc                      Chapter 6 Taming the MODEM
  1260.  
  1261.  
  1262.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  1263.         ZCOMM User Manual                                                   22
  1264.  
  1265.  
  1266.         7.  TAMING THE MODEM
  1267.  
  1268.         7.1  Hardware Interface
  1269.  
  1270.         DOS ZCOMM accesses serial ports at the standard COM1 and COM2 address,
  1271.         as well as COM3-COM7 as described with the port command.  The portx
  1272.         command may be used to access non standard 8250 port addresses.
  1273.  
  1274.         When a port is selected, a quick hardware check is made to verify the
  1275.         existience and minimal functionality of the port.  If this test fails,
  1276.         the message Port N Defective is displayed.  An incorrect port switch
  1277.         or strap (jumper) configuration is the usual cause of this message.
  1278.  
  1279.         This check does not guarantee the port is connected to the proper IRQ
  1280.         line.  If the port is not configured to use the proper IRQ line, the
  1281.         computer may lock up when the port is used.
  1282.  
  1283.         Some 8250 UART devices (used by serial interface adapters and internal
  1284.         modems) do not respond correctly when the software turns the
  1285.         transmitter interrupts on and off.  High performance communications
  1286.         programs such as ZCOMM require properly functioning UART chips, such
  1287.         as the National Semiconductor 16450 or 16550A.
  1288.  
  1289.         7.2  Carnival of the MODEMS
  1290.  
  1291.         Modem manufacturers are constantly refining their products and adding
  1292.         subtle new features.  To obtain the full performance your modem
  1293.         provides, you can edit initialization strings in the dialing scripts
  1294.         to take advantage of new modem features as they are developed.  For
  1295.         example, changing the X1 string sent by the dialing script to X2,X3 or
  1296.         X4 enables extra features on some modems.  Some modems do not emulate
  1297.         the Hayes Xn commands exactly, requiring a change to the Xn value
  1298.         emitted by the dialing script for proper operation.  The line in mm224
  1299.         to modify is:
  1300.  
  1301.              if !%MODEM put "ATX3\r";  wait -f2 :: Change this for your modem
  1302.  
  1303.         If your modem is not listed in one of the following subchapters,
  1304.         please read all the subchapters and use the suggestions that apply to
  1305.         modems similar to yours.
  1306.  
  1307.         7.3  Tone Dialing
  1308.  
  1309.         If your telephone line supports Tone Dialing, set mprefix to ATDT with
  1310.         a command in the setup telephone directory entry.  If your telephone
  1311.         line only supports rotary (pulse) dialing, set mprefix to ATDP.  This
  1312.         procedure is detailed in Chapter 0u.
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  
  1318.  
  1319.         (C) 1988 Omen Tech Inc                      Chapter 7 Taming the MODEM
  1320.  
  1321.  
  1322.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  1323.         ZCOMM User Manual                                                   23
  1324.  
  1325.  
  1326.         7.4  MNP, X.PC, LAPB, AFT
  1327.  
  1328.         Some modems are available with one or more error correcting link level
  1329.         protocols such as MNP.  Sometimes enabling MNP in a modem impairs
  1330.         logging into timesharing systems, packet switched networks, or
  1331.         bulletin boards.  In addition, non streaming protocols such as XMODEM,
  1332.         YMODEM, Kermit and Compuserve B give faster transfers without the
  1333.         delays introduced by MNP and other link level protocols.  Accordingly,
  1334.         ZCOMM's dialing scripts are designed to place calls with MNP disabled
  1335.         by default.
  1336.  
  1337.         The mm224 dialing script allows an optional link level modifier to be
  1338.         appended to each telephone number.
  1339.  
  1340.         The currently supported modifiers are:
  1341.  
  1342.         /300    Force a connection at 300 bps.  Dropping down to 300 bps may
  1343.                 be necessary to get a reliable connection in Oregon.
  1344.  
  1345.         /1200   Force a connection at 1200 bps.
  1346.  
  1347.         /nop    Suppress the detection of call progress reporting.  This may
  1348.                 be used to prevent the modem from misinterpreting an unusual
  1349.                 ringing sound as a busy signal.
  1350.  
  1351.         /fast   Force a high speed connection (refuse a slow speed
  1352.                 connection).
  1353.  
  1354.                 EXAMPLE: 123-4567/fast
  1355.  
  1356.  
  1357.         mnp     Require MNP link level connection.  Do not connect if MNP
  1358.                 fails.
  1359.  
  1360.                 EXAMPLE: 123-4567/mnp
  1361.  
  1362.  
  1363.         /mnp_s  Require MNP link level connection, use software flow control.
  1364.                 Do not connect if MNP fails.
  1365.  
  1366.         /a_mnp  Request MNP link level connection.
  1367.  
  1368.         /a_mnp_s Request MNP link level connection, use software flow control.
  1369.  
  1370.         /xmodem Enable "XMODEM spoofing" on Trailblazer modems.
  1371.  
  1372.         /kermit Enable "Kermit spoofing" on Trailblazer modems.
  1373.  
  1374.         NOTE: Most modems do not support all these modifiers.
  1375.  
  1376.  
  1377.  
  1378.  
  1379.         (C) 1988 Omen Tech Inc                      Chapter 7 Taming the MODEM
  1380.  
  1381.  
  1382.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  1383.         ZCOMM User Manual                                                   24
  1384.  
  1385.  
  1386.         7.5  MODEM environment variable
  1387.  
  1388.         The mm224 dialing routine uses the MODEM environment variable to
  1389.         indicate the type of modem it is driving.  Except for ZCOMM, the value
  1390.         inherited from the environment may be overridden with a set command.
  1391.         Currently supported values for MODEM are:
  1392.  
  1393.         MM224   MultiModem 224 without MNP.  This works with many other 2400
  1394.                 bps modems with little or no modification.
  1395.  
  1396.         MM224E  MultiModem 224E with MNP.
  1397.  
  1398.         SM1200  Hayes SmartModem 1200
  1399.  
  1400.         HV96    Hayes V series Smartmodem 9600
  1401.  
  1402.         TB      Telebit TrialBlazer
  1403.         Note: these values are all upper case.
  1404.  
  1405.  
  1406.         7.6  High Speed Modems
  1407.  
  1408.         The new generation of high speed dial-up modems presents special
  1409.         oppurtunities and challenges to users and system integrators.
  1410.  
  1411.         These modems transmit data at speeds from 110 to 38400 or more bits
  1412.         per second.  This range of speeds poses special problems communicating
  1413.         between the computer and the modem.  Lower speed modems examine the
  1414.         traditional "AT" command prefix bit by bit to lock onto the computer's
  1415.         transmission speed instantly.  Many modems which recognize commands at
  1416.         widely varying speeds can not use this technique.  A number of
  1417.         alternate techniques have been developed, each with its own advantages
  1418.         and problems.
  1419.  
  1420.           + Lock the interface to the highest tranmsission rate.  This aviods
  1421.             the programming required to synchronize the modem's and computer's
  1422.             speeds.  Flow control must be used when the interface speed is
  1423.             locked to prevent the computer from sending data more rapidly than
  1424.             the modem can buffer and transmit it.  This local flow control is
  1425.             usually accomplished with hardware signals.  When such an
  1426.             arrangement is used to communicate over networks that must assert
  1427.             their own flow control (with XON and XOFF), data flow regulation
  1428.             must respond to both hardware (RTS) and software (XOFF) signals.
  1429.             The handshake both command should be used whenever the modem's
  1430.             interface speed is locked and transmission over networks or to
  1431.             timesharing systems is desired.
  1432.  
  1433.             When the interface speed is locked at a higher speed than the
  1434.             actual data transmission, an excessive amount of data may be
  1435.             stored in the modem's memory awaiting transmission.  This is
  1436.             inefficient when a streaming file transfer protocol is used
  1437.  
  1438.  
  1439.         (C) 1988 Omen Tech Inc                      Chapter 7 Taming the MODEM
  1440.  
  1441.  
  1442.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  1443.         ZCOMM User Manual                                                   25
  1444.  
  1445.  
  1446.             because the data backed up in the buffer must be drained before
  1447.             error recovery can commence.  The ZMODEM b and w muneric
  1448.             parameters should be used to manage the modem's data storage.
  1449.  
  1450.             Locking the interface speed to 9600 or 19200 bps while
  1451.             communicating at 1200 and 2400 bps should be avoided unless all
  1452.             links in the transmission path have low error rates.
  1453.  
  1454.             Most modems do not recognize XOFF characters from the remote
  1455.             computer, so characters stored in the modem's buffer will be
  1456.             transmitted for a period of time after an XOFF is received.  This
  1457.             causes loss of data with some computer services.
  1458.  
  1459.           + Autobaud to adjust the modem and computer speed.  With this
  1460.             method, the modem is optioned to enter a search mode whenever it
  1461.             becomes idle.  The dialing script calls the waketb phone directory
  1462.             subroutine to train the modem to the computer's transmission
  1463.             speed.  The waketb subroutine may be optimized for the particular
  1464.             modem used.
  1465.  
  1466.             After dialing or answering a call, the modem handshakes with the
  1467.             remote modem and reports the connect speed with a message such as
  1468.             "CONNECT 1200" or "CONNECT FAST".  The dialing script recognizes
  1469.             the string, and sets the computer to the correct speed.  If the
  1470.             connection is made at high speed, the dialing script may need to
  1471.             enable hardware flow control with a handshake command.
  1472.  
  1473.  
  1474.         7.7  TELEBIT TrailBlazer
  1475.  
  1476.         The Telebit TrailBlazer modem uses 68000 and TMS320 processors to
  1477.         transmit serial data at rates up to 14000 bps over standard phone
  1478.         lines.  The modems also operate at speeds of 2400, 1200, 300 and
  1479.         slower.  The TrailBlazer is one of the most complex modems to fully
  1480.         exploit, a worthy challenge for a TurboDialTm script.  Use the mm224
  1481.         dialing routine discussed above for this modem.  The mm224 dial
  1482.         routine has special provisions to exploit this modem's features.  Set
  1483.         the MODEM environment variable to TB (caps are important) to support
  1484.         the TrailBlazer's MNP, speed and flow control features.
  1485.  
  1486.         Before making calls, use the inittb phone entry to initialize the
  1487.         modem's non volatile memory with proper settings for ZCOMM.
  1488.  
  1489.         EXAMPLE: call inittb
  1490.  
  1491.  
  1492.         ZMODEM provides optimum file transfer speeds with these modems.
  1493.         ZMODEM avoids interference with the modem's flow control.
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.         (C) 1988 Omen Tech Inc                      Chapter 7 Taming the MODEM
  1500.  
  1501.  
  1502.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  1503.         ZCOMM User Manual                                                   26
  1504.  
  1505.  
  1506.         7.8  MultiTech MultiModem 224E
  1507.  
  1508.         Special features of this modem are accessed with the mm224 dial
  1509.         script.  Set the MODEM environment variable to MM224E (caps are
  1510.         important) to support the MM224E's MNP, speed and flow control
  1511.         features.
  1512.  
  1513.         Set dip switch 1 on the bottom of the modem to up (DTR Normal), the
  1514.         reverse of the factory setting.  For high speed operation, CTS flow
  1515.         control should be enabled with internal switches and jumpers.
  1516.  
  1517.         Before making calls, use the initmm phone entry[1] to initialize the
  1518.         modem's non volatile memory with proper settings for ZCOMM.
  1519.  
  1520.         EXAMPLE: call initmm
  1521.  
  1522.         This disables automatic error correction under mnp.  If you wish to
  1523.         enable this setting, merely type, from the terminal mode, 'at &e0 &w',
  1524.         and the 'ok' which will ensue tells you that the command was accepted
  1525.         and stored in non-volatile memory.
  1526.  
  1527.         7.9  MultiTech MultiModem 224
  1528.  
  1529.         The autobaud feature of this and most other 2400 bps modems is
  1530.         accessed with the mm224 dial script.  This dialing script is the
  1531.         default choice in the distribution phones.t file.  Set the MODEM
  1532.         environment variable to MM224 (caps are important) to support the
  1533.         MM224.
  1534.  
  1535.  
  1536.         7.10  Hayes Smartmodem V9600
  1537.  
  1538.         This modem should be initialized with the inithv96 entry in the
  1539.         telephone directory.  The AFT link level is enabled by default because
  1540.         it does not appear to interfere with connections to modems not
  1541.         supporting AFT.
  1542.  
  1543.         7.11  Hayes Smartmodem 2400
  1544.  
  1545.         The Hayes Smartmodem 2400 presents the same same considerations as the
  1546.         Smartmodem 1200 described below.  Unlike the 1200, the 2400 uses a non
  1547.         volatile memory to store configuration parameters instead of the
  1548.         switches used in earlier models.  The sequence AT&C1 &D2 &R1 &S1 &T5
  1549.         &W should be sent to the modem to set normal operation for DCD, DTR,
  1550.         CTS, and DSR.  The T5 command disables remote loopback request, a
  1551.  
  1552.  
  1553.         __________
  1554.  
  1555.          1. Information courtesy Earle Robinson
  1556.  
  1557.  
  1558.  
  1559.         (C) 1988 Omen Tech Inc                      Chapter 7 Taming the MODEM
  1560.  
  1561.  
  1562.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  1563.         ZCOMM User Manual                                                   27
  1564.  
  1565.  
  1566.         source of failed file transfers on noisy lines.  Finally, the &W
  1567.         command writes this information to the non volatile memory.  Please
  1568.         consult your Hayes manual for more information on these commands.
  1569.  
  1570.  
  1571.         7.12  Hayes Smartmodem 1200
  1572.  
  1573.         The Smartmodem 1200 and similar 1200 bps modems are compatible with
  1574.         the mm224 telephone directory entry.  Some modems may require a change
  1575.         in the X1 command to a higher Xn digit for proper autobaud operation.
  1576.  
  1577.         The Smartmodem 1200(TM) should be configured as follows by setting
  1578.         S1-S8, located under the front panel.  These switches may be accessed
  1579.         by gently prying the ears of the front bezel, allowing the bezel to
  1580.         pop off the front of the unit.
  1581.  
  1582.         S1 Up Support DTR Lead
  1583.         S2 Up Verbal result codes (Verbose) [2]
  1584.         S3 Down Result codes are sent
  1585.         S4 Up Echoes characters in command state
  1586.         S5 Down Modem does not answer calls initially
  1587.         S6 Up Carrier Detect line reads status
  1588.         S7 ????  See Hayes manual
  1589.         S8 Down Enables Smartmodem 1200 command recognition
  1590.  
  1591.         The modem cable should connect the following RS-232 circuits: AA BA BB
  1592.         AB CF CD which use pins 1,2,3,7,8, and 20 on the Hayes modem.  Some
  1593.         programs require pins 5 and 6 connected to the modem.
  1594.  
  1595.         NOTE: Some Hayes modems require mprefix to be in upper case only.
  1596.         "Hayes Compatible" modems not manufactured by Hayes generally work
  1597.         with the same mprefix, but some of the other modem control strings
  1598.         that appear in the distributed PHODIR.t file may not work properly
  1599.         with a particular brand of modem.
  1600.  
  1601.  
  1602.         7.13  Microcom AX9624c
  1603.  
  1604.         Microcom AX modems have a configuration switch to select Hayes style
  1605.         "AT" commands.  The AX/9624c front dip switch should be set 1, 4, 6, 7
  1606.         UP, 2, 3, 5, 8 DOWN, and A/S OUT (asynchronous).  The rear switches
  1607.         are all UP.  Of all these switches, it is vital that front switch 2 be
  1608.         DOWN (AT commands) and rear switch 6 be UP; the initax9624 script
  1609.         should override the others.
  1610.  
  1611.  
  1612.         __________
  1613.  
  1614.          2. If other options are necessary (to support other software) a
  1615.             custom dial routine may be used as described in Chapter 99.
  1616.  
  1617.  
  1618.  
  1619.         (C) 1988 Omen Tech Inc                      Chapter 7 Taming the MODEM
  1620.  
  1621.  
  1622.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  1623.         ZCOMM User Manual                                                   28
  1624.  
  1625.  
  1626.         Set the MODEM environment variable to AX9624 (caps are important) to
  1627.         support the Microcom AX9624's MNP and flow control features.  Before
  1628.         making calls, use the initax9624 phone entry to initialize the modem's
  1629.         non volatile memory with proper settings for ZCOMM.
  1630.  
  1631.         EXAMPLE: call initax9624
  1632.  
  1633.  
  1634.  
  1635.         7.14  Microcom SX Series
  1636.  
  1637.         Older Microcom SX series modems have a unique command set incompatible
  1638.         with Hayes modems.  Furthermore, careful attention must be paid to
  1639.         flow control issues to obtain reliable operation.  When using XMODEM
  1640.         or other protocols, the modem must be set to pass all 8 bits and all
  1641.         256 code combinations of those 8 bits.  The dialsx script sets the
  1642.         modem to "transparent software flow control" as described in Chapter
  1643.         13.  Change the line
  1644.              set mcommand "gosub dial"
  1645.         to
  1646.              set mcommand "gosub dialsx"
  1647.         in the setup telephone directory entry.
  1648.  
  1649.  
  1650.         7.15  Novation Access 1-2-3
  1651.  
  1652.         The modem prefix should be set to "%D I".  When initializing, the
  1653.         modem should be set to 8 bit data mode with a putw "%F 4\r" [3]
  1654.         command.  The phones2.t file should be used as a basis for your
  1655.         phones.t file if this is your main modem.
  1656.  
  1657.         The Novation modem must be explicitly commanded to change speed with a
  1658.         "call 1200" or "call 300".
  1659.  
  1660.         Some modems may latch up if they are disturbed while dialing.  The
  1661.         modems may have difficulty recognizing dial tone.  A Novation "W"
  1662.         command may be used to force a wait and bypass listening for the dial
  1663.         tone.  "W" command(s) after the phone number also be useful when
  1664.         attempting to handshake with V.22bis (2400 bps) modems.  A custom
  1665.         "dial" script can also be used to manage the peculiarities of these
  1666.         modems.
  1667.  
  1668.         Users of the PC-jr Smartcat(TM) or similar modems should set mprefix
  1669.         to "\16 D " to provide the necessary command sequence for dialing.
  1670.         Many of the Novation Smartcat considerations discussed above apply to
  1671.  
  1672.  
  1673.         __________
  1674.  
  1675.          3. See Chapter 23 for a description of character escapes.
  1676.  
  1677.  
  1678.  
  1679.         (C) 1988 Omen Tech Inc                      Chapter 7 Taming the MODEM
  1680.  
  1681.  
  1682.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  1683.         ZCOMM User Manual                                                   29
  1684.  
  1685.  
  1686.         the PC-jr version.
  1687.  
  1688.  
  1689.         7.16  Prometheus ProModem 1200
  1690.  
  1691.         The following switch setting works with ZCOMM: 1-4,6,9 on; 5,7,8,10
  1692.         off.[4] A custom "dial" script can be written to operate this modem in
  1693.         its native mode.
  1694.  
  1695.  
  1696.         7.17  Racal-Vadic Maxwell 2400V
  1697.  
  1698.         The Maxwell 2400V has long delays designed to allow switching between
  1699.         data and voice operation on the same phone line.  Unfortunately, they
  1700.         slow normal data operations.  The 2400VP reportedly does not have this
  1701.         feature.
  1702.  
  1703.         Use the default mm224 dialing routine discussed above for this modem.
  1704.  
  1705.  
  1706.         7.18  Standard 103/212
  1707.  
  1708.         The supplied "dial" script will present the number to the user and
  1709.         wait for a success/fail response if the mprefix string parameter is
  1710.         set empty.  Alternatively, one could change the script to loop waiting
  1711.         for carrier detect while the keyboard is inactive.  The Data Set Ready
  1712.         (DSR) signal may be connected to the modem's speed detect output (high
  1713.         for 1200 bps, low for 300) allowing the dr test condition to sample
  1714.         the DSR line to determine the speed of the incoming call.
  1715.  
  1716.  
  1717.         7.19  Data Race BMX
  1718.  
  1719.         These modems have a switch selected interface speed, an AT style
  1720.         command set, and switch options for software or hardware flow control.
  1721.         Recommended settings are: AT commands, Dialup, 8 bit data (down),
  1722.         disable XON (7 and 8 down), Echo on.  ZCOMM's handshake on command
  1723.         should be used.
  1724.  
  1725.  
  1726.  
  1727.  
  1728.  
  1729.  
  1730.  
  1731.         __________
  1732.  
  1733.          4. Prometheus mode does not work with ZCOMM's built-in dialing
  1734.             software because the "DIAL COMPLETED" message makes ZCOMM think
  1735.             it's seen "CONNECT" (ZCOMM looks for a "T").
  1736.  
  1737.  
  1738.  
  1739.         (C) 1988 Omen Tech Inc                      Chapter 7 Taming the MODEM
  1740.  
  1741.  
  1742.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  1743.         ZCOMM User Manual                                                   30
  1744.  
  1745.  
  1746.         7.20  Strange Modems
  1747.  
  1748.         Most intelligent modems can be commanded to autodial with a suitable
  1749.         mprefix and msuffix string.  Those modems that won't work with a
  1750.         particular mprefix can be programmed with a custom "dial" script.  If
  1751.         the modem can be configured to reset to a known condition when DTR is
  1752.         turned off, programming is usually straightforward.
  1753.  
  1754.         Otherwise, the script must determine what speed the modem is set to,
  1755.         and then,  at its present speed, command the modem to change to the
  1756.         desired speed.  The essential requirement is to write a script that
  1757.         controls the modem and responds to its state.  The information on
  1758.         scripts in Chapter 99 should prove useful.
  1759.  
  1760.  
  1761.         7.21  Manual Dialing with Smart Modems
  1762.  
  1763.         Some hotels and exotic locales sport telephone systems with unusual
  1764.         dialing requirements.  It may be necessary to dial the call with the
  1765.         telephone, talk to an operator, and then activate the modem.  With
  1766.         Hayes compatible modems, an ATD command may be given to the modem to
  1767.         connect it to the line and attempt a data handshake.
  1768.  
  1769.  
  1770.         7.22  Direct Connection
  1771.  
  1772.         ZCOMM works well communicating with locally connected microcomputers,
  1773.         minicomputers, or mainframes with direct RS-232 connections.  For such
  1774.         applications, only transmit and receive data data signals need be
  1775.         connected to the computer.  The Carrier Detect line[5] should be
  1776.         driven ON (+5 volts) to prevent noise on this signal by strapping it
  1777.         to Data Terminal Ready [6] if no other signal is available.
  1778.  
  1779.         For best high speed operation, replace 8250 or 16450 UART chips with
  1780.         the NS16550AN chip.  ZCOMM enables the hardware buffering on this chip
  1781.         to avoid data loss caused by TSR programs, special device drivers,
  1782.         extended memory disks or caches, and DOS clock interrupts.
  1783.  
  1784.  
  1785.  
  1786.  
  1787.  
  1788.  
  1789.  
  1790.  
  1791.         __________
  1792.  
  1793.          5. Pin 8 on 25 pin RS-232 connector, pin 1 on PC-AT 9 pin connector.
  1794.  
  1795.          6. Pin 20 on RS-232 connector, pin 4 on PC-AT 9 pin connector.
  1796.  
  1797.  
  1798.  
  1799.         (C) 1988 Omen Tech Inc              Chapter 7 Your Telephone Directory
  1800.  
  1801.